AWS Systems Manager - Run Automation Runbook

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Content Index

When a new sentinel incident is created, this playbook gets triggered and runs the specified AWS Systems Manager Automation Runbook. The playbook will wait for the runbook execution to complete and then update the incident with the runbook execution status.

Attribute Value
Type Playbook
Solution AWS Systems Manager
Source View on GitHub

Logic App Connectors

This playbook uses 2 Logic App connectors / built-in actions:

Connector / Action Type Connections Actions
azuresentinel Managed 1 1
function Built-in 0 3
Action parameters (URLs, paths, function IDs)

azuresentinel (Managed)

Action Method Endpoint Other
Add_comment_to_incident_(V3) post /Incidents/Comment —

function (Built-in)

Action Method Endpoint Other
GetAutomationExecution_status — — functionId=[concat(variables('AWSSSMFuntionsAppId'), '/functions/GetAutomationExecution')]
GetAutomationExecution — — functionId=[concat(variables('AWSSSMFuntionsAppId'), '/functions/GetAutomationExecution')]
StartAutomationExecution — — functionId=[concat(variables('AWSSSMFuntionsAppId'), '/functions/StartAutomationExecution')]

Additional Documentation

📄 Source: AWSSystemsManagerPlaybooks/AWS-SSM-RunAutomationRunbook/readme.md

AWS-SSM-RunAutomationRunbook

Summary

When a new sentinel incident is created, this playbook gets triggered and performs the following actions:

  1. It executes the automation runbook with provided parameters.
  2. Adds a comment to the incident with the success/failure status of the runbook execution.



Prerequisites

  1. Prior to the deployment of this playbook, AWS Systems Manager API Function App Connector needs to be deployed under the same subscription.
  2. Refer to AWS Systems Manager API Function App Connector documentation to obtain AWS Access Key ID, Secret Access Key and Region.

Deployment instructions

  1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard.
  2. Fill in the required parameters:
    • Playbook Name
    • Automation Runbook Name
    • Runbook parameters in JSON format. Runbooks require specific permissions to execute, make sure they have proper permissions to perform action. Refer to Automation Runbook Reference for the list of parameters supported by the runbooks.
    • Function App Name - Name of the Function App where the AWS Systems Manager API Function App Connector has been deployed.

Deploy to Azure Deploy to Azure

Post-Deployment instructions

a. Authorize connections

Once deployment is complete, authorize each connection.

  1. Click the Microsoft Sentinel connection resource
  2. Click edit API connection
  3. Click Authorize
  4. Sign in
  5. Click Save
  6. Repeat steps for other connections

b. Assign Playbook Microsoft Sentinel Responder Role

  1. Select the Playbook (Logic App) resource
  2. Click on Identity Blade
  3. Choose System assigned tab
  4. Click on Azure role assignments
  5. Click on Add role assignments
  6. Select Scope - Resource group
  7. Select Subscription - where Playbook has been created
  8. Select Resource group - where Playbook has been created
  9. Select Role - Microsoft Sentinel Responder
  10. Click Save

c. Function App Settings Update Instructions

Refer to AWS Systems Manager API Function App Connector documentation for Function App Application Settings (Access Key ID, Secret Access Key and Region) update instruction.

References

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Playbooks · Back to AWS Systems Manager